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Technical  Debt  Metaphor 


“Shipping  first  time  code  is  like  going  into  debt. 

A  little  debt  speeds  development  so  long  as  it 
is  paid  back  promptly  with  a  rewrite...” 


“...  The  danger  occurs  when  the  debt  is 
not  repaid.  Every  minute  spent  on  not- 
quite-right  code  counts  as  interest  on 
that  debt.” 


Cunningham,  W.  1992.  The  WyCash  Portfolio  Management  System.  OOPSLA'92  Experience  Report, 
http  ://c2  .CO  m/doc/oopsi  a92 .  htm  I . 
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How  are  Architecture  and  Technical  Debt 
Related? 

Can  we  really  avoid  technical  debt? 


increasing  scale  of  systems 


heterogeneous  and 
uncertain  workforce 


systems  expected  to  be 
in  operation  and  sustainment 
for  decades 
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Metaphors  and  Analogies 


A  metaphor  is  a  cognitive  transfer  from  one 
domain  to  another  one.  The  use  of  metaphor 
allows  experiences  from  one  domain  to  illuminate 
our  understanding  of  another  domain. 


An  analogy  is  a  comparison  between  two  things 
on  the  basis  of  their  structure  and  the  purpose  of 
explanation  and  clarification. 


Wikipedia 
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Technical  Debt  Analogy 


When  and  how  was  the  debt  signed  under? 
What  is  the  payback  term? 

What  is  the  interest  rate? 
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Technical  Debt  - 

Steve  McConnell 


Typel 

Type  2 

unintentional,  non-strategic; 
poor  design  decisions,  poor 
coding 

intentional  and  strategic:  optimize 
for  the  present,  not  for  the  future. 

2.  A  short-term:  paid  off  quickly 
(refactorings,  etc.) 

2.B  long-term 

Implemented  features  (visible  and  invisible)  =  assets  =  non-debt 

McConnell,  S.  2007.  Technical  Debt.  10x  Software  Development  [cited  2010  June  14]; 
http://blogs.construx.eom/blogs/stevemcc/archive/2007/1 1  /01  /technical-debt-2. aspx. 
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Cost  of  Change  (CoC) 


Technical  Debt  - 

Jim  Highsmith 

Customer 


Years 


•  Only  on  far  right  of  curve,  all 
choices  are  hard 

•  If  nothing  is  done,  it  just  gets  worse 

•  In  applications  with  high  technical 
debt  estimating  is  nearly  impossible 


Highsmith,  J.  2009.  Agile  Project  Management:  Creating  Innovative  Products  ,  Addison-Wesley. 
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Technical  Debt  - 

Philippe  Kruchten 


Visible  Invisible 


Positive 

Value 

Negative 

Value 


Visible 

Feature 


Hidden, 

architectural 

feature 


Technical  debt 


Kruchten,  P.  2009.  What  colour  is  your  backlog?  Ag\\e  Vancouver  Conference.  http://pkruchten.wordpress.com/Talks. 
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Polling  Question 


In  which  of  these  areas  do  you  observe  technical  debt  the  most? 

•  Code;  our  code  has  become  very  hard  to  maintain  due  to  clones, 
cycles,  random  bug  fixes 

•  Architecture;  we  have  made  suboptimal  architectural  decisions  that 
we  need  to  rearchitect  soon 

•  Process;  we  have  skipped  practices  such  as  reviews,  necessary 
testing  and  documentation  that  we  are  now  paying  for 

•  All  of  the  above 

•  None  of  the  above 
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Only  Three  Strategies 


Do  nothing,  it  gets  worse 
Replace,  high  cost/risk 

Incremental  refactoring,  commitment  to  invest 
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Why  Take  on  Debt 


Shortening  time 
to  market 

Preservation  of 
startup  capital 

Delaying 

development 

expense 


needed 


Invest-  Repayment 

ment  period 

period 


Profit 

period 


Self-  Break 

fjnding  even 

point  time 


Denne,  M.,  Cleland-Huang,  J.  2003.  Software  by  Numbers,  Prentice  Hall. 
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Deciding  to  Take  on  Debt  -1 


Market  loves  it 


Denne,  M.,  Cleland-Huang,  J.  2003.  Software  by  Numbers,  Prentice  Hall. 
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Deciding  to  Take  on  Debt  -2 


-1M 


’0 


>  S 


-1M 

p  +4M 


NPV  (P2)  =  -1 M  +  0.5x3M  +  0.5x1  M  =  1 M 


Taking  technical  debt  has  increased  system  value. 
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Deciding  to  Take  on  Debt  -3 


NPV  (P3)  =  -1 M  +  0.67  X  2.5M  +  0.33  x  1 M  =  1 .005  M 
More  realistically: 

Debt  +  interest 

High  chances  of  success 
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Deciding  to  Take  on  Debt  -4 


Add  feature 


Not  debt  really,  but  options  with  different  values... 
Do  we  want  to  invest  in  architecture,  in  test,  etc... 
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Tracking  and  Analyzing  Debt 

Eliciting  debt  and  quantifying  the  impact  is  not  a  repeatable 
engineering  practice  yet. 

•  Factors  to  consider  include  defects,  velocity,  cost  of  rework 

•  Mapping  such  indicators  onto  cost  of  development 

•  Comparing  with  the  value  of  paying  back  debt  versus  not 

Analysis  tools,  mostly  looking  at  code  metrics,  provide 
quality  insights 
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Tracking  and  Monitoring  -1 

First  more  capabilities 


Then,  more  infrastructure 


neglected  cost  of 
delay  to  market 


underestimated 
re-archItectIng  costs 


First  more  infrastructure  Then,  more  capabilities 


Brown,  N.,  Nord,  R.,  Ozkaya,  I.  2010.  Enabling  Agility  through  Architecture,  Crosstalk,  Nov/Dec  2010. 
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Tracking  and  Monitoring  -2 


Standard  iteration  management  in  agile  development 
^  functional,  high-priority  stories  allocated  first. 


Focus  on  Value 


Velocity 


Accumulated  suboptimal 
architecture  and  need  to  wait 


Tracking  and  monitoring  mechanism  is  solely  based  on 
customer  features  delivered. 
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Tracking  and  Monitoring  -3 


Standard  iteration  management  in  architecture-centric 
development  processes 

^  up-front  requirements  and  design  tasks  allocated  first. 


Focus  on  Cost 


No  explicit  and  early  tracking  and  monitoring  mechanisms  that 
is  development  artifact  specific. 
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Measurable  Insights  into  Delivery 

Added  cost  as  a  result  of 

—  ■  » *  1  1  implementing  architecture  in 

Economic  Models  retrospect 


Path  1 :  value  focused; 
functionality  first. 


Path  2:  cost  focused; 
architecture  push. 


Capabilities  delivered 
at  different  times 


E 

u 


20 


C| 

— 

zr 

20  40  60  80  100  120  1 

Cumulative  Cost  (as  %) 

Value  of  Capabilities  Delivered 
over  Total  Effort 


aggregating  the  amount  of 
rework  at  each  iteration  based 
on  architecture  changes 
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I  Code  Rework 
I  Code  ImpI 
I  Arch  Rework 
I  Arch  impi 


Iteration 
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Technical  Debt  and  Tools 


There  has  been  an  increasing  focus  on  tools  for  the  purpose 
of  structural  analysis. 

Trends  show 

•  increasing  sophistication, 

•  support  for  some  structurai  anaiysis  in  addition  to  code  anaiysis, 

•  first  steps  towards  anaiyzing  financiai  impact  by  relating 
structure  anaiysis  to  cost  and  effort  for  rework. 
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Tools  for  Structural  Analysis 


Architecture-Related  Capabilities* 

•  Architecture  Visualization  Techniques 

•  Architecture  Quality  Analysis  Metrics 

•  Architecture  Compliance  Checking 

•  Architecture  “Sandbox” 


Not  all  tools  have  all  capabilities 
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Tools  for  Technical  Debt  Analysis  - 

Architecture  Visualization  Techniques* 


•  Dependency  Structure  Matrix 

•  Conceptual  Architecture 

•  Architectural  Layers 

•  Dependency  Graph 


Telea,  A.;  Voinea,  L.;  Sassenburg,  H.; ,  "Visual  Tools  for  Software  Architecture  Understanding: 
A  Stakeholder  Perspective,"  Software,  IEEE  ,  vol.27,  no. 6,  pp. 46-53,  Nov.-Dee.  2010. 

Not  all  tools  use  all  architecture  visualization  techniques. 
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Tools  for  Technical  Debt  Analysis  - 

Architecture  Quality  Analysis  Metrics* 
Capabilities  -5 


•  Component  Dependencies 

•  Cyclicity 

•  Architectural  Rules  Compliance 

•  Architectural  Debt 

•  The  following  slides  show  representative  architecture  quality  analysis  metrics  from  the  following  sources: 

•  Lattix.  Lattix  Releases  Lattix  5.0.  httD://www.iattix.com/node/38 

•  SonarSource,  Sonar.  Metric  definitions.  httD://docs.codehaus.ora/displav/SONAR/Metric+definitions 

•  Hello2morrow,  SonarJ.  Sonar  Integration,  http://www.hello2morrow.com/products/sonari/sonar 

•  CAST,  Application  Intelligence  Platform.  http://www.castsoftware.com/Product/Application-lntelliaence-Platform.aspx 
Not  all  tools  have  all  Architecture  Quality  Analysis  Metrics 
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Deciding  to  Pay  Down  Debt 


Eliciting  business  indicators  that  accumulate  the 
interest  on  debt: 

•  Increased  amount  of  defects 

•  Slowing  rate  of  velocity 

•  Change  of  business  and  technology  context 

•  A  future  business  opportunity 

•  Time  to  market 
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Strategies  and  Techniques 


Part  of  standard  operating  procedure 

•  Adding  technical  debt  to  the  backlog 

•  Amortize  1 0% 

•  Specialized  iteration:  hardening  cycle,  hackathon 

Architectural  tactics* 

•  Align  feature  and  system  decomposition 

•  Architectural  runway 

•  Matrixed  teams 


*  Bachmann,  R;  Nord,  R.;  Ozkaya,  I..;  ,  “Architectural  Tactics  to  Support  Rapid  and  Agile 
Stability"  Crosstalk ,  May/June  2012. 
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Economic  Models  - 

Release  Planning  - 1 


Kruchten,  P.  2009. 

What  colour  is  your  backlog? 

Agile  Vancouver  Conference. 
http://pkruchten.wordpress.com/Talks. 


Time 
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In  which  release? 


Copyright  ©  2010  by  Philippe  Kruchten 
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Economic  Models  - 

Release  Planning  -  2 


Time 
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Value  decreases  over  time 
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Economic  Models  - 

Release  Planning  -  3 


Time 
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Technical  debt  increases? 


Copyright  ©  2010  by  Philippe  Kruchten 
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Future  Directions  in  Technical  Debt  Anaiysis  - 

Open  Areas  of  Investigation  -1 

Technical  debt  succinctly  communicates  the  issues 
observed  in  large-scale,  long-  term  projects: 

•  There  is  an  optimization  problem  where  optimizing  for  the  short-term 
puts  the  long-term  into  economic  and  technical  jeopardy  when  debt  is 
unmanaged. 

•  Design  shortcuts  can  give  the  perception  of  success  until  their 
consequences  slow  down  projects. 

•  Software  development  decisions,  especially  architectural  ones,  need 
to  be  continuously  analyzed  and  actively  managed  as  they  incur  cost, 
value,  and  debt. 
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Future  Directions  in  Technical  Debt  Analysis  - 

Open  Areas  of  Investigation  -2 

How  to  locate  most  effective  refactoring  opportunities? 
How  to  identify  and  manage  strategic  architectural  debt? 
How  does  debt  manifest  itself  in  non-code  artifacts? 

How  does  debt  relate  to  development  processes? 

How  can  debt  be  visualized  with  effective  tool  support? 
How  to  identify  dominant  sources  of  debt? 

How  and  when  to  pay  back  debt? 

How  to  measure  debt? 


Brown,  N.,  Cai,  Y,  Guo,  Y,  Kazman,  R.  ,  Kim,  M.,  Kruchten,  R,  Lim,  E.  ,  MacCormack,  A.,  Nord,  R.,  Ozkaya,  I., 
Sangwan,  R.,  Seaman,  C. ,  Sullivan,  K.,  Zazworka,  N. ,  2010.  Managing  Technical  Debt  in  Software-Reliant 
Systems,  FSE/SDP  Workshop  on  the  Future  of  Software  Engineering  Research,  Santa  Fe  November  201 0. 
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Things  We  Can  Do  Now 


Practices  that  can  be  incorporated  into  managing  projects: 

•Make  technical  debt  visible. 

•Differentiate  strategic  structural  technical  debt  from  technical  debt  that 
emerges  from  low  code  quality. 

•Bridge  the  gap  between  the  business  and  technical  sides. 

•Integrate  technical  debt  into  planning. 

•Associate  technical  debt  with  risk. 
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Concluding  Thoughts 


Agile  manifesto 

the  only  true  measure  of  progress  on  a  software  development 
project  is  the  delivery  of  working  software 

Architecture  proposition 

the  only  true  measure  of  progress  on  a  software  development 
project  is  the  delivery  of  working  software  that  meets  its  business  and 
quaiity  goais 

Integrated  approach  for  large  scale  systems 

the  only  true  measure  of  progress  on  a  software  development 
project  is  the  delivery  of  working  software  that  meets  its  business  and 
quaiity  goats  today  and  in  the  future  through  batancing  anticipation 
and  adaptation 
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NO  WARRANTY 


THIS  CARNEGIE  MELLON  UNIVERSITY  AND  SOFTWARE  ENGINEERING  INSTITUTE 
MATERIAL  IS  FURNISHED  ON  AN  “AS-IS"  BASIS.  CARNEGIE  MELLON  UNIVERSITY 
MAKES  NO  WARRANTIES  OF  ANY  KIND,  EITHER  EXPRESSED  OR  IMPLIED,  AS  TO 
ANY  MATTER  INCLUDING,  BUT  NOT  LIMITED  TO,  WARRANTY  OF  FITNESS  FOR 
PURPOSE  OR  MERCHANTABILITY,  EXCLUSIVITY,  OR  RESULTS  OBTAINED  FROM 
USE  OF  THE  MATERIAL.  CARNEGIE  MELLON  UNIVERSITY  DOES  NOT  MAKE  ANY 
WARRANTY  OF  ANY  KIND  WITH  RESPECT  TO  FREEDOM  FROM  PATENT, 
TRADEMARK,  OR  COPYRIGHT  INFRINGEMENT. 

Use  of  any  trademarks  in  this  presentation  is  not  intended  in  any  way  to  infringe  on  the 
rights  of  the  trademark  holder. 
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duplicate,  or  disclose  the  work,  in  whole  or  in  part  and  in  any  manner,  and  to  have  or 
permit  others  to  do  so,  for  government  purposes  pursuant  to  the  copyright  license  under 
the  clause  at  252.227-7013. 
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